home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / BUSINESS / SP53.ARJ / SP.DOC < prev    next >
Text File  |  1991-01-28  |  17KB  |  399 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.           1. INTRODUCTION
  8.  
  9.            SP is a general purpose plotting package designed specially for
  10.           the scientific and   engineering professionals. The program is
  11.           designed to run   on an IBM-pc or compatibles. The SP has a
  12.           capability to plot  files containing upto 225,000 data pairs. It
  13.           can plot on linear, log, Normal probability, Log           normal
  14.           probability or Weibull scales. Data can     be curve fitted to
  15.           polynomials or smoothened with bicubic splines. Several functions
  16.           are available for transforming the data. The software does    not
  17.           include data editing capability . It works with data files in
  18.           ascii format. Hard   copy output can be produced on HP7470A
  19.           plotter. The graphics adapters supported are CGA/EGA and Hercules
  20.           monochrome.
  21.  
  22.  
  23.            2. LICENSE AND REGISTRATION
  24.  
  25.                 You may use SP without charge on a trial basis to determine
  26.           its suitability for you.  If you continue to use SP after    your
  27.           evaluation, a $25 registration   is requested. As a registered
  28.           user, you will receive a printed manual and information on future
  29.           updates. Questions and comments regarding this software should be
  30.           mailed to the following address.   You may  freely distribute SP
  31.           if you keep the entire package together and unchanged, including
  32.           this license explanation, and do not charge more than $5 for it.
  33.           The SP package is distributed as an archived file,    (SP53.ZIP),
  34.           which contains the following files :
  35.  
  36.             SP.EXE          SP executable
  37.             SP.DOC          SP documentation
  38.             ROCKWL.DAT      Sample data file
  39.             FATIG.DAT       Sample data file
  40.             HIST.DAT        Sample data file
  41.             SENDHPGL.EXE    Program for downloading HPGL file
  42.                             to a plotter
  43.  
  44.  
  45.           To register your copy of SP, send your name, address,and      $25
  46.           check to:
  47.  
  48.                        D. Dedhia
  49.                        P. O. Box 3298
  50.                        Santa Clara  CA 95055
  51.  
  52.           The registered users can acquire the complete source code for SP
  53.           (written in QuickBASIC) for $195.
  54.  
  55.           SP is provided as is.    There are no warranties expressed or
  56.           implied.
  57.  
  58.           3. SYSTEM REQUIREMENTS
  59.  
  60.           The following minimum hardware is requred to run the SP software:
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.           IBM-pc or compatible computer
  68.           One floppy disk drive
  69.           385 K RAM
  70.           CGA, EGA or Hercules monochrome graphics adaptor
  71.           HPGL comatible pen plotter (optional)
  72.           Epson or compatible dot matrix printer(optional)
  73.  
  74.           4. INSTALLTION
  75.  
  76.           The SP  program is   distributed as an archived .ZIP file and
  77.           requires PKUNZIP (available from CIME bulletin board) to extract
  78.           the files contained in the archive. No other  installtion      is
  79.           required. Extract  the files to a working disk or to a hard disk.
  80.           For program execution, only  SP.EXE is required.   If you have a
  81.           HPGL plotter connected to either COM1 or COM2 port,   the switch
  82.           settings on the plotter  should correspond to 9600 baud, 7 data
  83.           bits, 1 stop bit, and parity space. On   the HP7470A plotter, it
  84.           corresponds to the following switch settings :
  85.  
  86.           Switch number   S2  S1  Y  US  B4  B3  B2  B1
  87.            Set            0   0   0  1   1   0   1   0
  88.  
  89.           5. STRUCTURE OF DATA FILES
  90.  
  91.           The SP can read two types of data files :
  92.  
  93.           Type 1 : This type  of file can have upto 16 columns and upto
  94.           15,000 rows data. The first column is read in as X array,     the
  95.           second as Y1 array, the third as Y2 array, and so forth. The X-Y1
  96.           array is defined as SET 1, X-Y2 array is defined as SET 2, etc.
  97.           The first few lines   of the file can contain text (a string
  98.           starting with a non-numeric character) .   Each record (row) of
  99.           data should end with carriage return . The     sample data file
  100.           ROCKWL.DAT is of Type 1.
  101.  
  102.           Type 2 : This type of file can contain upto 15 SETS of X-Y pairs
  103.           of data, each set containing upto 15,000 pairs.  Each set of data
  104.           is separated by non-numeric text. The file should contain only 2
  105.           columns of data. Each record (row) of data should be separated by
  106.           a carriage return. The sample file FATIG.DAT is of type 2.
  107.  
  108.  
  109.  
  110.           6. SYMBOLS AND SYMBOL CODES
  111.  
  112.           The SP contains 10 discrete plotting symbols and     10 type of
  113.           lines. A data set can also be plotted as  histogram. By default,
  114.           symbols 11 thru 20 are assigned to the first 10 data sets, and 1
  115.           thru 5 to 11th thru 15th data set. User can reassign the  symbols
  116.           in any order.
  117.  
  118.           7. USER INSTRUCTIONS
  119.  
  120.  
  121.  
  122.  
  123.  
  124.           The SP can be invoked at the DOS prompt as follows :
  125.  
  126.           SP<CR>
  127.  
  128.           when prompted, enter name of the data file to be plotted
  129.  
  130.           The following display appears. This is the main plotting menu.
  131.  
  132.           A : Min-Max values X-Minimum X-Maximum Y-Minimum Y-Maximum
  133.                                          10         0        12
  134.           B : Tic Intervals  X-Major   X-Minor   Y-Major   Y-Minor
  135.                                 2         1         2         1
  136.           E : X-Axis Label=`Distance from surface (in)'
  137.           E : Y-Axis Label=`Hardness (Rc)'
  138.           M : Mode (Linear/Log) : X-Axis...LIN           Y-Axis...LIN
  139.           F : Physical plot size: X-Axis.. 3.5 - 25  Y-Axis.. 3.5-18.5 cms
  140.           G : Data Set # :    1   2   3   4   5   6
  141.               Symbols   :     11  12  13  14  15  16
  142.           P : Pen Number:     1   1   1   1   1   1
  143.           S : Save plotting  parameters in a file
  144.           L : Load plotting parameters from a file
  145.           X : Preview   Z : Plot on a pen plotter D:Change character sizes
  146.           T : Transformations :  X-axis  None            Y-axis  None
  147.           O : OVERPLOT OPTION TOGGLE(OFF)   H : Legend & Text
  148.           N : READ A NEW DATA FILE      C : Curvefit Menu       Q: QUIT
  149.           CURRENT FILE IS ..ROCKWL.DAT
  150.  
  151.                       Enter desired option to change format or to plot
  152.  
  153.  
  154.           When this menu appears, a plot can be viewed on the screen     by
  155.           pressing X. Any of   the settings listed on this menu can be
  156.           changed by pressing the   corresponding letter that appears in
  157.           front of each setting or command. A description   of each of the
  158.           options is given below :
  159.  
  160.           A : Min-Max values : By default, the minimum and the maximum   of
  161.           the data are used    as plotting limits. When this option is
  162.           selected, the user will be prompted to enter the  new limits for
  163.           plotting. Data that   fall outside these limits will not be
  164.           plotted.
  165.  
  166.           B: Tic Intervals : By default, there are five major tic-intervals
  167.           on each axis, and  for every major tic-interval, there are five
  168.           minor tic intervals. To completely suppress the minor         tic
  169.           intervals, enter the tic interval as zero. Do no  enter zero for
  170.           the major tic interval.
  171.  
  172.           E: Axes Labels : This option can be used to redefine X- and Y-
  173.           axis labels. Both upper and lower case characters can be used.
  174.  
  175.           M: Plotting Mode : One of   the following plotting mode can be
  176.           selected
  177.  
  178.  
  179.  
  180.  
  181.  
  182.           1. linear on X, linear on Y (default)
  183.           2. linear on X, log on Y
  184.           3. log on X , linear on Y
  185.           4. log on X, log on Y
  186.           5. linear on X, Normal probability scale on Y
  187.           6. log on X, Normal probability scale on Y (Log Normal)
  188.           7. log on X, Weibull on Y (Weibull scale)
  189.  
  190.           For log scales,   the all the data should be >0. For Normal
  191.           probability and Weibull scales , the data  should Be >0  and <1.
  192.  
  193.           F : Physical plot size : This option is applicable           only
  194.           applicable to HPGL pen plotters. By selecting this option,    the
  195.           physical size of the plot is specified as lengths (in cms) of the
  196.           X- and Y-axis and  the coordinated of the left-bottom corner of
  197.           the plot. The default values for lengths of X-and Y-axes      are
  198.           21.5 cms and 15 cms, respectively. The left-bottom corner is 3.5
  199.           cms up and right to the edges of the paper.
  200.  
  201.  
  202.           G : Symbols : A set of ten discrete symbols and 10 types of lines
  203.           are provided. By selecting this option,   the user can reassign
  204.           symbols to the data sets. To suppress plotting of a data set set,
  205.           select its symbol code as zero.
  206.  
  207.           P : Pen Number : This   option is applicable only to multi-pen
  208.           plotters. By selecting this option, different pens can         be
  209.           assigned to the data sets.
  210.  
  211.           S : Save Plotting Parametes : When this option  is selected, the
  212.           user is prompted to enter a file   name for saving the plotting
  213.           parameters. This parameter file can then be recalled later using
  214.           the L option.
  215.           L : Load Plotting Parameters : This option is used to recall  the
  216.           plotting parameters saved in a file using the S option.
  217.  
  218.           X : Preview : This  option is used to preview the plot on the
  219.           screen.
  220.  
  221.           Z : This option is used  to send plot to the plotter or to save
  222.           the HPGL commands to a file.
  223.  
  224.           D : Character Size : This option is used to change the size of
  225.           characters for writing tic labels, axes labels, legends and text.
  226.           The character sizes are applicable only to HPGL plotters.
  227.  
  228.           (T) : Transformations : This option is used   to tranform the X-
  229.           and/or Y-arrays by one of the following transformations :
  230.  
  231.           ID   Transformation
  232.  
  233.           0.   Znew = Zold
  234.  
  235.  
  236.  
  237.  
  238.  
  239.           1.   Znew = A + B * Zold
  240.  
  241.           2.   Z    = A + B *Ln( Z   )
  242.                 new               old
  243.  
  244.           3.   Znew = A + ( Zold) B
  245.  
  246.                                Z
  247.           4.   Znew = A +( B)   old
  248.  
  249.  
  250.           where Z refers to the X- or Y- arrays. Transformations are always
  251.           performed on the original  data and for the purpose of plotting
  252.           only. The data file is not affected.
  253.  
  254.  
  255.           O : Overlay Option : This option is applicable only to the   HPGL
  256.           plotters. When this option is on, frame, tic labels, and axes
  257.           labels are not plotted. By default, this option is turned off.
  258.  
  259.           (N) New data file : This option is used to select another    data
  260.           file for plotting. Only one file can be plotted at a time.
  261.  
  262.           (C) Curvefit  : When this option is selected,  the Curvefit Menu
  263.           is displayed (see the CURVEFIT MENU)
  264.  
  265.           (Q) Quit : This option is used to exit from the plotting program.
  266.  
  267.           (H) Legend and Text : This option is used to enter the legends (
  268.           a short line of text describing each data set)  and additional 5
  269.           lines of text. This option is used to write the legends and  text
  270.           on the plot while previewing on the screen and then plotting to a
  271.           file. If the plotting is to be done directly to a plotter,    the
  272.           user will be prompted to position the pen and enter the text    ,
  273.           after all the data are plotted.
  274.  
  275.           Curvefit Menu : This menu is displayed when option  C is pressed
  276.           from the plotting menu
  277.  
  278.           Equations available for curve fitting --
  279.  
  280.           1.  Y = A + B*X
  281.           2.  Y = A + B*X + C*X^2
  282.           3.  Y = A + B*X + C*X^2 + D*X^3
  283.           4.  Y = A + B*X + C*X^2 + D*X^3 + E*X^4
  284.           5.  Y = A + B*X + C*X^2 + D*X^3 + E*X^4 + F*X^5
  285.           6.  Y = A + B*X + C*X^2 + D*X^3 + E*X^4 + F*X^5 + G*X^6
  286.           7.  Y = A + B*X + C*X^2 + D*X^3 + E*X^4 + F*X^5 + G*X^6 + H*X^7
  287.           8.  Y = A + B*X + C*X^2 + D*X^3 + E*X^4 + F*X^5 + G*X^6 + H*X^7 +
  288.           I*X^8
  289.           9.  Spline-smoothen
  290.  
  291.            Number of user-input data sets = 1
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.           New Sets #     2  3  4  5  6   7   8   9   10  11  12  13  14  15
  299.           Data Set #     0  0  0  0  0   0   0   0   0   0   0   0   0   0
  300.           Equation #     0  0  0  0  0   0   0   0   0   0   0   0   0   0
  301.  
  302.            New set # ( Enter 0 to Exit) ?
  303.  
  304.           The number of curve fits that can be performed  is 15-the number
  305.           of user defined data sets. For example to curve fit data set 1 to
  306.           equation 3, and to put the result in a new data set, define
  307.           New Set# as 2
  308.           Data Set# as 1
  309.           Equation # as 3
  310.           Any user  defined data set can be curve fitted to as many
  311.           equations as desired, limited only by   the available number of
  312.           data sets. Enter zero to exit from the menu. If the curve     fit
  313.           option is selected, the user is next prompted to enter a filename
  314.           to save the results of the curve fits.
  315.  
  316.           PREVIEW SUB-MENU :
  317.  
  318.           When the Preview(x) option is selected form the plotting menu, a
  319.           plot of the data   is displayed , and  following options are
  320.           displayed at the bottom :
  321.  
  322.           F1 : Fast         F2 : Slow         F5 : Done        F10 : accept
  323.  
  324.           A cursor is displayed on the graph. The cursor can be moved    by
  325.           using the cursor keys   on the numeric keypad. The X- and Y-
  326.           coordinated of the cursor location are displayed at the bottom of
  327.           the screen.  The function keys F1 and F2 can be used to speed up
  328.           or slow down the cursor movement, respectively.      If you are
  329.           planning to send the plot to a file, and if you have      entered
  330.           legends and text using the H option from the  plot options menu,
  331.           then the key F10 can be used to place the legends and text on the
  332.           plot. First position the cursor where you wish     to place the
  333.           legends and then press the function key F10. The legends for all
  334.           the data set would   be printed on the plot. Follow the same
  335.           procedure for upto five additional lines  of text. Press the key
  336.           F5 to exit from the  loop. Then press Y to return to the plot
  337.           options menu.
  338.  
  339.           (Z) PLOT TO A PEN PLOTTER :  This option is selected to to send
  340.           the plot to a pen plotter or to send the HPGL commands to a file.
  341.  
  342.  
  343.            8. HINTS FOR EFFICIENT USE OF SP
  344.  
  345.           a. The following keystrokes will produce a plot on the screen and
  346.           on a HPGL plotter -
  347.  
  348.                SP <cr>             Start the program
  349.                <cr>
  350.                ROCKWL.DAT<cr>      Enter the name of the data file
  351.  
  352.  
  353.  
  354.  
  355.  
  356.                x                   Preview on the screen
  357.                F5                  Done
  358.                 Y                  Go back to the main menu
  359.                 Z                  Plot on a HPGL plotter
  360.                 <cr>               No rotation
  361.                 <cr>                    Plot appears on the plotter
  362.  
  363.  
  364.           b. The following keystrokes will produce a plot on the     screen
  365.           and save the HPGL commands to a file  -
  366.  
  367.                SP <cr>             Start the program
  368.                <cr>
  369.                ROCKWL.DAT<cr>      Enter the name of the data file
  370.                x                   Preview on the screen
  371.                F5                  Done
  372.                 Y                  Go back to the main menu
  373.                 Z                  Send plotter output to a file
  374.                 <cr>               No rotation
  375.                ROCKWL.HPL<cr>           Plotter output will be saved in
  376.                                    this file
  377.  
  378.           c. PRINTGL  software , available   on the CIME BBS can convert
  379.           these HPGL files to print on a variety   of dot-matrix and laser
  380.           printers.
  381.  
  382.           d. To use this program with a hercules card, load MSHERC.COM,
  383.           before running SP.
  384.  
  385.           e. SENDHPGL program can be used to download a HPGL file (created
  386.           by this  program or any other software) to a plotter. Run
  387.           SENDHPGL, and follow the instructions that appear on the monitor.
  388.  
  389.           9. OTHER RELATED PROGRAMS :
  390.  
  391.           If you find this program useful, you may   also be interested in
  392.           acquiring the following programs, all of which are distributed as
  393.           shareware.
  394.  
  395.           NP51     : Normal Probability & Histogram Plotting Program
  396.           CCHARTS  : X-bar, r, c and p control charts program
  397.  
  398.           Registration for each program is $25 and the source  code can be
  399.           acquired for $195.